home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / fortran / fmt.com / FMT.DOC < prev    next >
Encoding:
Text File  |  1989-01-24  |  18.0 KB  |  465 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                       FMT
  9.                       Automatic FORTRAN FORMAT Statements
  10.                                  Version 1.30
  11.                                    (c) 1989
  12.  
  13.                          "One of many STATOOLS(tm)..."
  14.                                       by
  15.  
  16.                                Gerard E. Dallal
  17.                                53 Beltran Street
  18.                                Malden, MA  02148
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                     NOTICE
  34.  
  35.             Copyright 1989 by Gerard E. Dallal.  FMT is shareware.  If
  36.         you find FMT to be useful,  a non-exclusive license fee of $12
  37.         should be sent to the author.
  38.  
  39.  
  40.  
  41.                                   DISCLAIMER
  42.  
  43.             STATOOLS  are  provided  "as  is"  without warranty of any
  44.         kind.  The entire risk as to  the  quality,  performance,  and
  45.         fitness   for  intended  purpose  is  with  you.   You  assume
  46.         responsibility for the selection of the program  and  for  the
  47.         use of results obtained from that program.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                                                                 PAGE 2
  54.  
  55.  
  56.                               PROGRAM DESCRIPTION
  57.  
  58.             FMT  takes  the  drudgery  out  of  writing FORTRAN FORMAT
  59.         statements.  Simply use a word processor  or  text  editor  to
  60.         create  an  ASCII  file  that looks just like the output you'd
  61.         like your program to produce.  FMT turns the model into a  set
  62.         of  FORMAT  statements  that  can  be pasted into your FORTRAN
  63.         program.  For example, FMT turns
  64.  
  65.                                 Monthly Report
  66.                                      Wages
  67.  
  68.                  Employee Name           Salary +  Fringe   =  Total
  69.                Last        First
  70.  
  71.           {           }  {       }      ^^^^.^^    ^^^^.^^    ^^^^.^^
  72.  
  73.         into
  74.  
  75.           *   33X,'Monthly Report'/
  76.           *   38X,'Wages'/
  77.           *   /
  78.           *   18X,'Employee Name',11X,'Salary +  Fringe   =  Total'/
  79.           *   16X,'Last',8X,'First'/
  80.           *   /
  81.           *   11X,A13,'  ',A9,6X,F7.2,4X,F7.2,4X,F7.2/
  82.  
  83.  
  84.  
  85.                                    OPERATION
  86.  
  87.             The input to FMT is an ASCII file  containing  the  output
  88.         that is to be transformed into FORTRAN FORMAT statements.  The
  89.         file  should look just the way it is to appear on screen.  FMT
  90.         automatically adds the leading  blank  character  required  by
  91.         FORTRAN.
  92.  
  93.             The name of the input file must  have  the  qualifier  UNF
  94.         (for  "UNFormatted").  The resulting FORMAT statements will be
  95.         written to a file with the same basename and the qualifier FMT
  96.         (for "ForMaTted").  For  example,  when  DESIGN  is  given  in
  97.         response to the FMT prompt
  98.  
  99.                 Enter basename for text to be formatted.
  100.                        unformatted .UNF, formatted .FMT:
  101.  
  102.  
  103.         FMT                                                G.E. Dallal
  104.  
  105.  
  106.  
  107.                                                                 PAGE 3
  108.  
  109.         the  text  file  DESIGN.UNF  is  used  to  create  the  FORMAT
  110.         statement file DESIGN.FMT.
  111.  
  112.         Numerical data
  113.  
  114.             Digits are represented by carets.  Floating point  numbers
  115.         are  distinguished  by  the presence of a decimal point in the
  116.         string.
  117.  
  118.                             ^^^^   becomes I4
  119.                            ^^^^.   becomes F5.0
  120.                          ^^^.^^^   becomes F6.3
  121.  
  122.         Numerical fields  cannot  run  into  each  other.  FMT  cannot
  123.         distinguish between 2I2 and I4.
  124.  
  125.         Character data
  126.  
  127.             The tilde (~) represents a CHARACTER*1  variable  (A1).  A
  128.         substring  of  'n'  tildes  becomes  nA1 in the FMT file.  The
  129.         first and last characters of  character  variables  of  length
  130.         greater  than  1  are  denoted by the left brace ({) and right
  131.         brace (}), respectively.
  132.  
  133.                       ~~~~~~~~~~~~  becomes  12A1
  134.                       {          }  becomes  A12
  135.                       {   }~~~{  }  becomes  A5,3A1,A4
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.         FMT                                                G.E. Dallal
  158.  
  159.  
  160.  
  161.                                                                 PAGE 4
  162.  
  163.  
  164.                                      NOTES
  165.  
  166.             1.  The  qualifier  UNF  is  not  added to the basename in
  167.                 response to the FMT prompt.
  168.  
  169.             2.  Blank  lines in the UNF file become slashes (/) in the
  170.                 FMT file.
  171.  
  172.             3.  Lines in the UNF file with a period (.) in  the  first
  173.                 column become blank lines in the FMT file.
  174.  
  175.             4.  Carets  (^),  tildes  (~),  and braces ({,}) cannot be
  176.                 used as text in the UNF file.  If these characters are
  177.                 necessary,  use a surrogate in the UNF file and use  a
  178.                 text  editor  to  replace  them after the FMT file has
  179.                 been created.
  180.  
  181.             5.  Unbalanced braces will cause the program to  terminate
  182.                 with an error message.
  183.  
  184.             6.  Single  quotes  may appear in the UNF file.  They will
  185.                 be doubled appropriately in the FMT file.
  186.  
  187.  
  188.                                 UPDATE HISTORY
  189.  
  190.             1.01 -- Lines ending in Fw.0 no longer have ,'' before the
  191.                        final  slash.  The  extra  characters  did  not
  192.                        affect  the  behavior  of the FORMAT statement;
  193.                        they merely looked unsightly.
  194.  
  195.             1.10 -- Internal enhancements not affecting output.
  196.  
  197.             1.20 -- Long  character  strings with embedded commas  now
  198.                        split properly.
  199.                     ASCII  250  and 255   (PC-Write's  hard  and  soft
  200.                        spaces) automatically translated to spaces.
  201.  
  202.             1.30 -- Long  formats  now split properly when break  does
  203.                        not occur within a character string.
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.         FMT                                                G.E. Dallal
  212.  
  213.  
  214.  
  215.                                                                 PAGE 5
  216.  
  217.                        DUPLICATION AND SHAREWARE NOTICES
  218.  
  219.             You may  distribute  unmodified  copies  of  FMT  and  its
  220.         documentation provided there is no charge beyond a duplication
  221.         fee not to exceed $6.
  222.  
  223.             FMT is shareware.  If you find FMT to be  useful,  a  non-
  224.         exclusive license fee of $12 should be sent to the author.
  225.  
  226.  
  227.                                REGISTRATION FORM
  228.  
  229.             Licensed from:
  230.  
  231.                   Gerard E. Dallal
  232.                   53 Beltran Street
  233.                   Malden, MA  02148
  234.  
  235.  
  236.             Date:      /   /
  237.             ----------------------------------------------------------
  238.                                        Qty      Fee       Fee
  239.                      ITEM                       each      extended
  240.  
  241.             FMT:  Automatic FORTRAN
  242.                 FORMAT Statements            x  $12   =
  243.                   (license fee)       -----               --------
  244.  
  245.             FMT distribution disk            x   $5   =
  246.                                       -----               --------
  247.  
  248.                                              SUBTOTAL
  249.                                                           --------
  250.  
  251.                      5% Sales Tax (MA residents only)
  252.                                                           --------
  253.  
  254.  
  255.                                                 TOTAL
  256.                                                           --------
  257.  
  258.                  Please make check payable to Gerard E. Dallal
  259.  
  260.                  You may keep a copy of this invoice for your
  261.                                  tax records.
  262.  
  263.  
  264.  
  265.         FMT                                                G.E. Dallal
  266.  
  267.  
  268.                                  STATOOLS(tm)
  269.  
  270.         STATOOLS(tm) is a set of stand-alone programs designed to fill
  271.         in some of the gaps left by major statistical program packages
  272.         such as SAS, SPSS-X, BMDP, and SYSTAT:
  273.  
  274.         STAT-SAK is the STATistician's Swiss  Army  Knife.  While  not
  275.         the custom tool for any particular job,  it carries out a wide
  276.         variety of miscellaneous tasks that are not  easily  performed
  277.         by most large statistical packages.  These include probability
  278.         distributions (normal,  t,  chi-square,  F, binomial, Poisson,
  279.         studentized range);  exact confidence intervals  for  binomial
  280.         p's;  Fisher's  exact test for 2 by 2 tables;  Mantel-Haenszel
  281.         test and approximate 95% confidence interval  for  the  common
  282.         odds  ratio;  Bartholomew's  test  for increasing proportions;
  283.         Bartholomew's test for increasing normal means;  one  and  two
  284.         sample   t-tests   from   summary   statistics;    correlation
  285.         coefficients:  test that a population value is  0,  confidence
  286.         interval  for  a  single coefficient,  test of equality of two
  287.         independent coefficients,  test of equality of  two  dependent
  288.         coefficients (coefficients from the same correlation matrix).
  289.  
  290.         PC-SIZE  determines  the  sample  size requirements for single
  291.         factor experiments, two factor experiments,  randomized blocks
  292.         designs,  paired  t-tests,  and comparison of proportions.  It
  293.         can calculate the power of specific sample sizes  as  well  as
  294.         determine the sample size needed to achieve specific power.
  295.  
  296.         PC-PLAN generates randomization plans.
  297.  
  298.         PC-EMS produces tables of expected mean squares  for  balanced
  299.         experiments using the Cornfield-Tukey algorithm.
  300.  
  301.         PC-PITMAN,   calculates  observed  significance  levels  using
  302.         recursive   relationships   to   obtain   the    randomization
  303.         (permutation)  distribution  of a number of statistics without
  304.         directly examining all possible permutations of the  data.  It
  305.         performs one and two sample randomization tests and rank tests
  306.         in the presence of an arbitrary number of ties in the data.
  307.  
  308.         PC-MULTI  performs multiple comparisons using Tukey's honestly
  309.         significant differences (studentized range statistic).
  310.  
  311.         FORGET-IT produces Forget-it  Plots  (also  known  as  Two-way
  312.         Plots),  a  graphical  device  for  displaying the interaction
  313.         structure of a two-way table.
  314.  
  315.         STRUCTR  fits  structural  relations  when  the ratio of error
  316.         variances is known.
  317.  
  318.         PC-AIP fits additive-in-the-probits models to  two-dimensional
  319.         contingency  tables  with   ordered  column   classifications.
  320.         To  obtain  a  set  on  three  diskettes  (for  the IBM PC and
  321.         compatibles running DOS 2.0 or later versions) containing  the
  322.         source code, executable files, and user's guides, send a check
  323.         in the amount of $15 to
  324.  
  325.  
  326.                               Gerard E. Dallal
  327.                               53 Beltran Street
  328.                               Malden, MA  02148
  329.  
  330.  
  331.         Other programs:
  332.  
  333.         OCTA (One man's Contingency Table Analysis):  Interactive log-
  334.         linear analysis of multi-dimensional contingency tables by use
  335.         of   the   Deming-Stephan   iterative   proportional   fitting
  336.         procedure.   Quasi-independence   models;   Brown's  tests  of
  337.         partial and multiple association.  Tables of up to 1000  cells
  338.         containing  no  more  than  7 dimensions and 20 categories per
  339.         dimension.  ($10)
  340.  
  341.         LOGISTIC:  Logistic regression.  Maximum likelihood  estimates
  342.         of  the  regression  coefficients  are  obtained  by  use of a
  343.         Newton-Raphson  iterative  procedure.   Interactions  may   be
  344.         specified  in the model.  The right hand side of the model may
  345.         contain up to 20 terms.  Analyzes data in MYSTAT/SYSTAT system
  346.         files.  ($10)
  347.  
  348.         cLOGISTIC:  Conditional  logistic  regression  for  stratified
  349.         case-control data. Up to 500 strata with no more than 10 cases
  350.         plus controls per  stratum.  The  product  of  the  number  of
  351.         subjects  and  the number of variables must be no greater than
  352.         6000.  ($5 OR formatted 5-1/4"  floppy  diskette  in  a  self-
  353.         addressed  stamped  mailer.  Also,  accompanies LOGISTIC at no
  354.         additional charge.)
  355.  
  356.         PITMAN:  A  version  of PC-PITMAN (described above) that works
  357.         with data in SYSTAT/MYSTAT  files.  ($5  OR  formatted  5-1/4"
  358.         floppy diskette in a self-addressed stamped mailer)
  359.  
  360.         TRACK:  Foulkes-Davis tracking index, the probability that two
  361.         individuals chosen at random will have measurement curves that
  362.         do not cross.  Fits linear, quadratic, or cubic polynomials to
  363.         each  individual's  data  and  judges the adequacy of the fit.
  364.         Analyzes  data  in  MYSTAT/SYSTAT  system  files.  Produces  a
  365.         command  file  that allows SYGRAPH (Systat,  Inc.) to draw the
  366.         measurements curves.  ($5 OR formatted 5-1/4" floppy  diskette
  367.         in a self-addressed stamped mailer)
  368.  
  369.         WUBA-WUBA:  Converts  space  or comma delimited ASCII files of
  370.         numerical data to MYSTAT/SYSTAT files. ($5 OR formatted 5-1/4"
  371.         floppy diskette in  a  self-addressed  stamped  mailer.  Also,
  372.         accompanies  any  program  that analyzes data in SYSTAT/MYSTAT
  373.         files at no additional charge.)
  374.  
  375.         GENERIC:  Set of FORTRAN source code that can  be  used  as  a
  376.         template   for  writing  MYSTAT/SYSTAT  supplements.   ($5  OR
  377.         formatted 5-1/4" floppy diskette in a  self-addressed  stamped
  378.         mailer)
  379.         RCJOIN:  identifies  sources of interaction in two-dimensional
  380.         tables of counts (Computers and Biomedical Research, 21(1988),
  381.         129-136) ($5 OR formatted 5-1/4" floppy diskette  in  a  self-
  382.         addressed stamped mailer)
  383.  
  384.         MUDIFT:  Multivariate distribution-free comparison  of  growth
  385.         curves. (Guo S, Simon R, Talmadge JE, Klabansky RL.  Computers
  386.         and Biomedical Research,  20(1987), 37-48.) Works with data in
  387.         MYSTAT/SYSTAT files.  MUDIFT was written with Shumei  Guo,  R.
  388.         Simon,  J.E. Talmadge,  and  R.L. Klabansky.  ($5 OR formatted
  389.         5-1/4" floppy diskette in a self-addressed stamped mailer)
  390.  
  391.         BUMP:  Dose-response curves in the  presence  of  a  downturn.
  392.         (Simpson and Margolin,  Biometrika, 73(1986), 589-596).  Works
  393.         with data  in  MYSTAT/SYSTAT  files.  BUMP  was  written  with
  394.         Douglas G.  Simpson and is available from him at Department of
  395.         Statistics,  University  of Illinois at Urbana-Champaign,  101
  396.         Illini Hall, 725 South Wright Street, Champaign, IL 61820. ($5
  397.         OR  formatted  5-1/4"  floppy  diskette  in  a  self-addressed
  398.         stamped mailer)
  399.  
  400.         FMT:  FORTRAN FORMAT  Statement  Generator.    Use  your  word
  401.         processor to create a  text file looking  like the output  you
  402.         want from  your FORTRAN  program.   FMT  turns the  text  into
  403.         FORTRAN FORMAT statements.  ($5 for a disk containing FMT; $12
  404.         shareware registration)
  405.  
  406.  
  407.             A word about MYSTAT...
  408.  
  409.         MYSTAT is a full-featured subset  of  the  statistics  package
  410.         SYSTAT  by Systat,  Inc.  MYSTAT can analyze up to 32000 cases
  411.         and 50 variables.  It contains a full-screen editor which  can
  412.         import  ASCII  files and,  through an extensive transformation
  413.         facility,  create new variables and modify existing variables.
  414.         MYSTAT's  statistical capabilities include summary statistics,
  415.         scatterplots,  histograms,  stem-and-leaf displays,  t  tests,
  416.         correlation  coefficients,  regression analysis,  balanced and
  417.         unbalanced multi-way analysis of variance, and the analysis of
  418.         two  dimensional  tables  of  counts.   MYSTAT  will  soon  be
  419.         packaged  with  number  of  introductory statistics textbooks.
  420.         Anyone may obtain a free copy of MYSTAT by sending  a  written
  421.         request to Systat,  Inc.,  1800 Sherman Avenue,  Evanston,  IL
  422.         60201. (Reference:  Wilkinson, L.  (1987), "MYSTAT: A Personal
  423.         Version of SYSTAT," The American Statistician, 41,  334.) I am
  424.         unable to provide copies of MYSTAT.
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.          ----------------end-of-author's-documentation---------------
  432.  
  433.                         Software Library Information:
  434.  
  435.                    This disk copy provided as a service of
  436.  
  437.                         The Public (Software) Library
  438.  
  439.          We are not the authors of this program, nor are we associated
  440.          with the author in any way other than as a distributor of the
  441.          program in accordance with the author's terms of distribution.
  442.  
  443.          Please direct shareware payments and specific questions about
  444.          this program to the author of the program, whose name appears
  445.          elsewhere in  this documentation. If you have trouble getting
  446.          in touch with the author,  we will do whatever we can to help
  447.          you with your questions. All programs have been tested and do
  448.          run.  To report problems,  please use the form that is in the
  449.          file PROBLEM.DOC on many of our disks or in other written for-
  450.          mat with screen printouts, if possible.  The P(s)L cannot de-
  451.          bug programs over the telephone.
  452.  
  453.          Disks in the P(s)L are updated monthly, so if you did not get
  454.          this disk  directly from the P(s)L,  you should be aware that
  455.          the files in this set may no  longer be the current versions.
  456.  
  457.          For a copy of the latest monthly software library newsletter
  458.          and a list of the 1,600+ disks in the library, call or write
  459.  
  460.                         The Public (Software) Library
  461.                               P.O.Box 35705 - F
  462.                            Houston, TX 77235-5705
  463.                                (713) 665-7017
  464.  
  465.